home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / p2fdc13.zip / PCB2FDC.DOC < prev    next >
Text File  |  1993-06-05  |  12KB  |  300 lines

  1.            
  2.            
  3.            
  4.            
  5.            
  6.            
  7.            ▀█▀▀▀▀█ █▀▀▀▀█ ▀█▀▀▀▀█                          █
  8.             █    █ █       █    █                          █
  9.             █▄▄▄▄█ █       █▄▄▄▄▀ █▀▀▀▀█ ▀▀▀▀▀█ █▀▀▀█ █▀▀▀▀█
  10.             █      █       █    █ █    █ █▀▀▀▀█ █   ▀ █    █
  11.            ▄█▄     █▄▄▄▄█ ▄█▄▄▄▄█ █▄▄▄▄█ █▄▄▄▄█ █     █▄▄▄▄█
  12.  
  13.  
  14.  
  15.  
  16.                                     ▄▀▀▄ 
  17.                                    ▀    █
  18.                                       ▄▀ 
  19.                                     ▄▀   
  20.                                    █▄▄▄▄▄
  21.  
  22.  
  23.  
  24.  
  25.          █▀▀▀▀▀                           █▀▀▀▀▄
  26.          █                            ▄   █    █
  27.          █▄▄▄   █▀▀▀█ █▀▀▀▀█ █▀▀▀▀█ ▄▄█▄▄ █    █ █▀▀▀▀█ █▀▀▀▀█ █▀▀▀█
  28.          █      █     █    █ █    █   █   █    █ █    █ █    █ █   ▀
  29.          █      █     █▄▄▄▄█ █    █   █▄  █▄▄▄▄▀ █▄▄▄▄█ █▄▄▄▄█ █
  30.  
  31.  
  32.                 █▀▀▀▀█
  33.                 █                                  ▀█
  34.                 █      █▀▀▀▀█ █▀▀▀▀█ █▀▀▀▀▀ █▀▀▀▀█  █  █▀▀▀▀█
  35.                 █      █    █ █    █ ██████ █    █  █  ██████
  36.                 █▄▄▄▄█ █▄▄▄▄█ █    █ ▄▄▄▄▄█ █▄▄▄▄█ ▄█▄ █▄▄▄▄▄
  37.  
  38.                                  Version 1.3
  39.  
  40.  
  41.               Brought to you by Tom Carroll and Dataware Software
  42.  
  43.  
  44.  
  45.                             Copyright (C) 1992-93
  46.                                      by
  47.                                  Tom Carroll
  48.  
  49.  
  50.                              All rights reserved
  51.  
  52.  
  53.  
  54.                               The Data Shop BBS
  55.                          (509)582-9493 (16.8k HST/DS)
  56.                                 Kennewick, WA
  57.                            FIDO address (1:3407/1)
  58.  
  59.                           MAGIC FILE NAME: PCB2FDC
  60.     ┌──────────────┐
  61.     │ INTRODUCTION │
  62.     └──────────────┘
  63.  
  64.     This program only supports PCBoard systems that run FrontDoor (FD) and
  65.     InterMail (IM).  This is not a statement by me that either one is the best
  66.     mailer out there, it just says that I use FD on my system and IM has the
  67.     same structures as FD. <grin>  I decided to write a program that writes
  68.     directly to the mailer console, but I found an easier way after I
  69.     downloaded the FD Developers info packet.  It seems FD (and IM) uses
  70.     semaphore files so other applications can communicate with them.  Well,
  71.     I was able to figure out that I could write info to the LASTCALL.xx file
  72.     and therefore place the last BBS caller info into the last mail To: record.
  73.  
  74.     ┌──────────────┐
  75.     │  DISCLAIMER  │
  76.     └──────────────┘
  77.  
  78.     This software is provided without any guarantee or warranty either expressed
  79.     or implied.  I will not be held responsible for ANY damages that may result
  80.     in the use of this program.  "ANY" means if you install it, run it, and it
  81.     eats your programs that you've been working on for 2 years without a backup,
  82.     IT'S NOT MY FAULT!!!
  83.  
  84.     PCB2FDC software and this document is Copyright (C) 1992-93 by Tom Carroll,
  85.     All rights reserved.
  86.  
  87.     ┌──────────────┐
  88.     │   LICENSE    │
  89.     └──────────────┘
  90.  
  91.     This program is being released as FREEWARE.  The source code will remain
  92.     the property of the author unless otherwise released by him.
  93.  
  94.     You are free to use this version of the program without any cost of
  95.     registration.  This however, may change at any time with a new version
  96.     release. (If this should happen, a one time registration fee will be asked)
  97.  
  98.     No one may alter, modify, or reverse engineer PCB2FDC for any reason,
  99.     including but not limited to decompiling-compiling, patching, or
  100.     disassembling.
  101.  
  102.     You may freely distribute & copy this program for others subject to the
  103.     above restrictions and the following:
  104.  
  105.          ■ PCB2FDC is copied in unmodified form including this file. 
  106.          ■ There is no charge for copying except for the cost of disks.
  107.          ■ PCB2FDC is not included in another software package without
  108.            the express written permission of Tom Carroll.
  109.  
  110.     ┌──────────────┐
  111.     │   SUPPORT    │
  112.     └──────────────┘
  113.  
  114.     If you should find any problems with this program, or you have any requests
  115.     or recommendations, you may reach me on my BBS, or at the FIDO address
  116.     listed on the front cover.  I may also be reached in the QUIK_BAS & PCBNET
  117.     FIDO echo's, UNI', ILink, and Global Link Sysop conferences, or on SaltAir.
  118.  
  119.  
  120.     PCB2FDC v1.3                                                         Page 2
  121.     ┌──────────────┐
  122.     │  THE AUTHOR  │
  123.     └──────────────┘
  124.  
  125.     I have been writing in BASIC for about 8 years, and I really like it, but 
  126.     I've been planning on taking a course in "C", but still haven't...
  127.  
  128.     I am presently active duty in the U.S. Coast Guard, and have been a "Sysop"
  129.     for their computer systems at my duty stations for about 7 years.
  130.  
  131.     I would like to thank my wife, who always says "Are you coming to bed, or
  132.     are you going to keep PLAYING on that computer?"
  133.  
  134.     ┌──────────────┐
  135.     │    FILES     │
  136.     └──────────────┘
  137.  
  138.     Files included in this archive:
  139.  
  140.               FILE_ID.DIZ  - Description file for PCB2FDC
  141.               PROGRAMS.DWS - List of Dataware Software products
  142.               PCB2FDC.DOC  - Documentation for PCB2FDC
  143.               PCB2FDC.EXE  - PCB2FDC Executable.
  144.               PCB2FDC.HIS  - PCB2FDC History notes.
  145.  
  146.     I originally compressed this program as P2FDCnn.ARJ, but it may be
  147.     compressed with any other archive program you wish to use as long as all
  148.     the above listed files are included within the new archive.
  149.  
  150.     The latest version will always be available on my BBS using the magic
  151.     filename of PCB2FDC or in conference #1 (Dataware Support).
  152.  
  153.     Sometimes, there may be a need for debug code to be released.  This code is
  154.     used to track down specific problems which aren't normally encountered on
  155.     my system.  I have a 386/sx-25 w/4megs of RAM, and DOS 5.0, which should be
  156.     pretty standard and generic, but sometimes this doesn't present an optimal
  157.     testing environment, so please, if you're having problems, and debug code
  158.     is available, feel free to FREQ P2FDEBUG from me, or if you're registered
  159.     on my BBS call and download PCB2FDC.ARJ from conference #1.  If it's not
  160.     available, then you're the first person that has reported a problem, so
  161.     please leave me your specifics, and any config files so I may be able to
  162.     trouble shoot the problem.
  163.  
  164.  
  165.     
  166.     
  167.     
  168.     
  169.     
  170.     Now, on with the installation...
  171.  
  172.  
  173.  
  174.  
  175.     
  176.     
  177.     
  178.     
  179.     
  180.     PCB2FDC v1.3                                                         Page 3
  181.     ┌──────────────┐
  182.     │    SETUP     │
  183.     └──────────────┘
  184.  
  185.     All you need to do is add the following command line to your $$LOGON.BAT
  186.     file:
  187.  
  188.        PCB2FDC C:\PCB\MAIN\USERS C:\FD\LASTCALL.xx /IN
  189.        (note:  xx should be replaced with FD or IM)
  190.  
  191.     Now enter this line in your $$LOGOFF.BAT file:
  192.     
  193.        PCB2FDC C:\PCB\MAIN\USERS C:\FD\LASTCALL.xx
  194.        (note:  xx should be replaced with FD or IM)
  195.     
  196.     Copy the PCB2FDC.EXE file to your PCBoard directory and you're all done!
  197.     
  198.     ┌──────────────┐
  199.     │  OPERATION   │
  200.     └──────────────┘
  201.  
  202.     PCB2FDC will read the PCBOARD.SYS upon logon, and then upon logoff, it will
  203.     read the users record using the USERNUMBER field originally retrieved from
  204.     the PCBOARD.SYS file and update the LASTCALL.xx file.
  205.     
  206.     When PCB2FDC initially reads the PCBOARD.SYS record, it retrieves the
  207.     USERNUMBER, and the time logged on (seconds since midnight) info.  It will
  208.     append this information to the end of the PCB2FDC.EXE file so you won't
  209.     have to worry about a config file.
  210.     
  211.     (NOTE:  This may confuse people if they try and determine if the program
  212.     they are using is the latest by comparing the date/time stamp of the file.
  213.     The file is a self-modifying .EXE and it will always have a current date.
  214.     To determine what version see the notes section later on.)
  215.     
  216.     After the user logs off, the info will be read from the PCB2FDC.EXE file
  217.     and then it opens the USERS file to retrieve the users full name, city,
  218.     security, and number of times on.  This info will be shown along with the
  219.     elapsed time online, and the date/time they logged off in the To: record
  220.     of the LASTCALL.xx file.
  221.  
  222.     Here is an example of what will be displayed, and the location of each piece
  223.     of information:
  224.  
  225.                                                ┌──────────────┐
  226.                                                │   ┌────────┐ │
  227.                                                v   v        │ │
  228.     To  : Tom Carroll <────────────┐          110:186/20 <┐ │ │
  229.           12-23-92 16:53 <───────┐ │       Kennewick, WA  │ │ │
  230.                                  │ │       ───────┬─────  │ │ │
  231.                                  │ │              │       │ │ │
  232.        Date/Time user logged off.┘ └────────────┐ │       │ │ │
  233.        Users name, formated to Upper/Lower case.┘ │       │ │ │
  234.        Users City and State Upper/Lower.──────────┘       │ │ │
  235.        Users Elapsed time on-line.────────────────────────┘ │ │
  236.        Number of times on (for new users).──────────────────┘ │
  237.        Callers security level.────────────────────────────────┘
  238.     
  239.     PCB2FDC v1.3                                                         Page 4
  240.     PCB2FDC should retain all info from the previous call should a newuser
  241.     fail to register on your BBS.  It will also work on doors that allow
  242.     the caller to hang up while inside of it. (such as mail doors)
  243.     ┌──────────────┐
  244.     │    NOTES     │
  245.     └──────────────┘
  246.  
  247.     To determine the current version you are running, you may type the
  248.     following command line:
  249.  
  250.     PCB2FDC /VER
  251.  
  252.     which will print the following info to your screen:
  253.  
  254.     Program  - PCB2FDC
  255.     Version  - <version number>
  256.     Compiled - <compile date>
  257.  
  258.     Another switch is available for my debugging purposes.  If you find
  259.     that the software isn't working properly, please include the /DEBUG
  260.     command line switch.  This will creadte a file called PCB2FDC.DBG
  261.     and it needs to be copied before the program executes again, otherwise
  262.     it will be overwritten.  Be sure to send me this file when you call,
  263.     which will help in tracking down the problem.
  264.  
  265.     I don't know if PCB2FDC will work in a network, Desqview, or multi-node
  266.     environment so I have no idea if it will operate on your system.  However,
  267.     you will have to have SHARE.EXE loaded for it to operate correctly.
  268.  
  269.     I do not know of any other limitations of PCB2FDC, but if you should
  270.     have a problem, please let me know.
  271.  
  272.     ┌──────────────┐
  273.     │  DONATIONS   │
  274.     └──────────────┘
  275.  
  276.     This version of software is free for the taking, but if you feel compelled
  277.     to make a donation, you may send whatever contribution that you feel is
  278.     reasonable to the following address:   
  279.                                            Dataware Software
  280.                                            1922 W. 4th Avenue
  281.                                            Kennewick, WA  99336
  282.  
  283.     I will be transfering in the summer or fall of 1993.  If you call my BBS
  284.     and do not get an answer, you may leave me mail in one of the networks
  285.     listed above, or contact one of the following these BBS's for a tech
  286.     support account.
  287.  
  288.                     The One Stop PCBoard       Arid Acres
  289.                         Gary Hedberg           John Allen
  290.                        (509)943-0211          (509)544-0116
  291.                          (v.32bis)             (v.32bis)
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.     PCB2FDC v1.3                                                         Page 5
  300.